Description

• Make soc-min and soc-max the canonical fields for fixed and dynamic storage SoC boundaries.
• Allow dynamic soc-min / soc-max values through sensor references and time-series specs.
• Add a generic default field to sensor references, so missing sensor values can be filled, e.g. {"sensor": 300, "default": "10 kWh"}.
• Keep soc-minima and soc-maxima supported as legacy aliases for dynamic soc-min and soc-max, while marking them deprecated in docs/OpenAPI metadata.
• Reject ambiguous payloads that define both dynamic soc-min and soc-minima, or both dynamic soc-max and soc-maxima.
• Preserve backwards compatibility for fixed soc-min / soc-max, including existing fixed soc-min plus legacy soc-minima usage.
• Update API examples, scheduling docs, UI schema text, and regenerated OpenAPI specs.
• Add changelog entry

Look & Feel

N/A

Example API flex-model shape:

{
  "soc-at-start": "12 kWh",
  "soc-min": {
    "sensor": 300,
    "default": "10 kWh"
  },
  "soc-max": {
    "sensor": 301,
    "default": "25 kWh"
  },
  "power-capacity": "5 kW"
}

How to test

• pytest:

uv run pytest \
  flexmeasures/data/schemas/tests/test_sensor.py \
  flexmeasures/data/schemas/tests/test_scheduling.py \
  flexmeasures/data/models/planning/tests/test_utils_fresh_db.py \
  flexmeasures/data/models/planning/tests/test_solver.py \

• Manual API-style check:
  Use a storage flex-model where soc-min and soc-max are dynamic sensor references with defaults:

{
  "flex-model": {
    "soc-at-start": "12 kWh",
    "soc-min": {
      "sensor": 300,
      "default": "10 kWh"
    },
    "soc-max": {
      "sensor": 301,
      "default": "25 kWh"
    },
    "power-capacity": "5 kW"
  }
}

Expected behavior: soc-min and soc-max are treated as dynamic SoC boundaries, and missing sensor values are filled with the provided default values.

Further Improvements

• Decide whether to add runtime deprecation warnings for soc-minima / soc-maxima.
• Handle recurring SoC limits separately in Recurring SoC limits #2255.

Related Items

• closes Make soc-minima and soc-maxima the default, simplifying usage #2251

Sign-off

• I agree to contribute to the project under Apache 2 License.
• To the best of my knowledge, the proposed patch is not based on code under GPL or other license that is incompatible with FlexMeasures